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SMARTBUG - AN INTELLIGENT MONITOR FOR THE 6800 


INTRODUCTION 


SMARTBUG is a 1024 byte monitor program which may be used 

in most systems using the Motorola 6800 microprocessor. 

It was designed primarily to replace the MIKBUG ROM used 

in many systems including the Southwest Technical Products 
6800 microcomputer. SMARTBUG is available from SMOKE SIGNAL 
BROADCASTING on a 2708 EPROM. In order to implement SMARTBUG 
in the SWTPC 6800 microcomputer system, SMOKE SIGNAL BROAD- 
CASTING has developed the P-38 series of EPROM boards. 

These boards are equipped with SMARTBUG and contain room 

for seven more 2708's so that the user can expand the monitor 
at any time. 


Most of the SMARTBUG subroutines start at the same address 
locations as the functionally equivalent MIKBUG subroutines. 
Thus, most programs designed to run with MIKBUG should require 
little, if any, modification to run with SMARTBUG. 


One major advantage of SMARTBUG is that it is available on a 
2708 Eraseable-Programmable Read Only Memory Chip. This 
means that the user may easily change the monitor to suit 
his individual system requirements simply by re-programming 
the 2708. 


WHY SMARTBUG? 


SMARTBUG has several new features not found in MIKBUG which 
make system operation easier; however, these are not the 
primary reasons for SMARTBUG, but are added bonuses. MIKBUG 
handles sérial I/O through the 6820 Parallel Interface Adapter 
which was designed for 8 bit parallel I/O and not serial I/O. 
MIKBUG requires the 6800 microprocessor to wait in timing 
loops while inputting or outputting data through the PIA. 
Thus, while the processor is writting a character, it cannot 
check to see if the user wishes to input a character at the 
same time. This limitation becomes quite noticeable to the 
user when trying to interrupt a program listing in BASIC 

(or any program that checks for user input while outputting 
data) by typing "CONTROL C". Many "C" keys have been worn 
out trying to get the program to recognize the user input. 
Also, while the processor is spinning its wheels in I/0 
timing loops, it cannot be doing any other work although 
this is usually unimportant except in real-time applications 
requiring fast servicing of interrupt requests. 


SMARTBUG handles I/O through the 6850 Asynchronous Communi- 


cations Interface Adapter. The 6850 was designed specifically 
to handle serial data. When writting data to the 6850, all 
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the microprocessor needs to do is check to see that the 6850 

is ready to receive data and then write an 8 bit word to the 
6850 in parallel form over the system data bus. This takes 

only a few instructions and very little time. While the 6850 

is converting the parallel data received from the microprocessor 
to serial and sending it to the output device, it can simul- 
taneously receive data. Thus, if you are running BASIC and 

type a "CONTROL C", the processor is "instantaneously" able 

to respond to your interrupt the first time you type "CONTROL 
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Another advantage of handling serial I/O through an ACIA is 
that baud rates in excess of 19,200 can be accomodated 
compared to a maximum baud rate of about 1200 baud that can 
be handled by MIKBUG. 


WHY MIKBUG? 


To the experienced hobbiest who has used MIKBUG, the limitations 
of handling serial I/O through a 6820 parallel I/O chip are 
intuitively obvious. If you are a newcomer, just accept it 

on faith that only a very strange person would use a 6820 for 
serial I/O instead of a 6850 in a general purpose microcomputer 
system. The question that is often asked is: "Why would a 

big company like Motorola do such a silly thing?". The answer 
is that in 1974 when MIKBUG was written, the 6850 was not 

yet in production and the 6820 was. In order to introduce 

the first 6800 evaluation kit, it was necessary to handle the 
serial I/O through a 6820 and MIKBUG was a very clever little 
device used to demonstrate how easy it was to use the 6800 
microprocessor. 


HARDWARE REQUIREMENTS 


SMARTBUG "talks" through a 6850 ACIA which should be located 
at $8008 and $8009. It also requires RAM at $A000 through 
$A06B. SMARTBUG itself is located at $E000 through $E3FF. 
In order to have the reset and interrupt vectors operate 
without external ROM, it is necessary to have SMARTBUG 
located at $FC00 through S$FFFF in addition to $E000 through 
SE3FF. The SMOKE SIGNAL BROADCASTING P-38 series of EPROM 
boards has a switch to allow SMARTBUG to occupy both of 
these areas or only the S$E0@0 through $E3FF area when using 
another 2708 in the $FC0O0 through S$FFFF area. To locate a 
6850 ACIA at $8008 and $8009, owners of the SWTPC 6800 should 
purchase a MP-S board and place it in I/O slot number 2. 

The MP-C control board in slot number 1 is no longer used 
and should be removed from the machine. 


USE OF HIGH BAUD RATES 


The maximum baud rate useable with MIKBUG is about 1200 baud. 
With SMARTBUG, it is possible to use baud rates of at least 
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19,200; however, for baud rates in excess of about 1200 

baud, it may be necessary to change the crystal in the 

SWTPC 6800. The MC14411P baud rate generator chip used 

in the SWTPC 6800 is designed to use a crystal frequency 

of 1.8432 MHz. The crystal supplied with the SWTPC 6800 

is a few percent lower in frequency due to an anomoly of 
MIKBUG. If you wish to take full advantage of SMARTBUG 

and use it's high baud rate capability, you may need a 
crystal of the correct frequency. Also, it will be necessary 
to bring the desired baud rate line out from the baud rate 
generator chip on the CPU board in place of one of the lower 
baud rates that you are not using. This requires a foil 

cut and jumper on the CPU card. Consult the CPU card instruc- 
tion manual and the MC14411P data sheet to determine the 
correct locations for your particular application. 


SOFTWARE OPERATION 
RESET 


Pressing the reset button on the SWTPC 6800 will cause 
SMARTBUG to output a carriage return, line feed and an 
asterisk (*) to the system terminal. As in MIKBUG, the 
asterisk is the prompt character; and, when it appears, 
SMARTBUG is waiting for the user to enter a command. One 
of the advantages of having your monitor in EPROM is that 
you are able to customize the monitor to your system. 
When SMARTBUG prompts with an asterisk, it is actually 
outputting the character string located at SE3F0 through 
SE3F6. If you are using a non-scrolling terminal such as 
the CT-1024, you may wish to change oneof the null (00) 
characters in this string to an "Erase to End of Line" 
character ($15 in the case of the CT-1024). 


COMMANDS 


After being prompted with an asterisk, the user may enter 
any valid SMARTBUG command. All SMARTBUG commands are 
single-letter commands followed, in some cases, by address 
information. The valid command letters are A, B,C,D,E,G, 
H,1,J,K,L,M,N,P,Q,R,T,X,4. Entering any other character 
will cause SMARTBUG to prompt again with an asterisk. 


"R" REGISTERS 


Typing "R" will cause SMARTBUG to display the various 
registers in the 6800 in the following format. 


*R CC BB AA XXXX PCPC SPSP 


Throughout this manual, user input is indicated by underlined 
characters. Output from SMARTBUG is not underlined. 


CC is the two hex digits representing the contents of the 
Condition Code Register 

BB is the contents of the B Accumulator 

AA is the contents of the A Accumulator 

XXXX is the contents of the Index Register (4 hex digits) 

PCPC is the contents of the Program Counter 

SPSP is the contents of the Stack Pointer 


Entering an "A" after the * prompt character will cause the 
contents of the A Accumulator to be displayed. To change 

the contents of the A Accumulator, simply type two hex 
characters. Type a carriage return to return to SMARTBUG 
without altering the contents of the A Accumulator. A sample 
format is shown below. 


*A XX YY 
where XX is the old contents of the A Accumulator and YY is 
the new contents entered by the user. 
"“B" EXAMINE AND CHANGE THE B ACCUMULATOR 
"B" allows the user to examine and change the contents of 
the B Accumulator and operates in the same manner as the 
"A" command. 
"C" EXAMINE AND CHANGE THE CONDITION CODE REGISTER 
"C" allows the user to examine and change the Condition Code 
Register and operates in the same manner as the "A" command. 
"X" EXAMINE AND CHANGE THE INDEX REGISTER 
"X" allows the user to examine and change the contents of 
the Index Register. This command operates in the same manner 
as the "A" command except that four hex characters are 
required for the "X" command instead of two. 
"M" MEMORY EXAMINE. AND CHANGE 
The "M" command allows the user to examine any memory location 
and to change any memory location occupied by RAM memory. 


To examine a memory location, type "M" followed by the four 
hex digits of the memory location you wish to examine. 
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EXAMPLE:  *M 0100 
*0100 7E BD 
*0101 El 


In the above example, the user typed "M" followed by "0100". 
SMARTBUG then typed *0100 7E. 7E was the old contents of 
0100. The user then typed "BD", thus changing the contents 
of 0100 to BD. SMARTBUG then proceeded to show the user 
the contents of 0101. 


To change a memory location, it is only necessary to type the 
two hex digits representing the new data. To return to 
SMARTBUG without changing the data, type a carriage return. 
To examine the following location without changing the 
present location, hit the SPACE BAR. To examine the pre- 
vious memory location, type "U" for up. 


GO _ TO USER'S PROGRAM 


Two commands are provided to transfer control from SMARTBUG 
to a user's program. The "G" command which operates in 

the same manner as the "G" command in MIKBUG and a new "J" 
command. | 


"G" GO TO LOCATION CONTAINED IN $A048 and $A049 


To use the "G" command, first use the "M" command to put 
the starting address of the program into memory locations 
$A048 and $A049. Then type "G". SMARTBUG will then jump 
to the location contained in $A048 and $A049. This command 
is useful when you will enter the program several times 
from SMARTBUG. When you only intend to enter the program 
from SMARTBUG once, the "J" command is more convenient. 


"J" JUMP TO LOCATION XXXX 


Typing "J" "XXXX" where XXXX are four hex digits will cause 
SMARTBUG to transfer program control to that location. 
EXAMPLE: *J 01A0 will cause SMARTBUG to jump to $01A0 and 
begin executing whatever program was previously stored 
beginning at that location. 


"I" INSERT 


FORMAT: I XXXX YYYY 2Z EXAMPLE: *I 0000 3FFF 3F 

This command will insert the two hex digits "ZZ" into 
memory locations "XXXX" through "YYYY". In the example, 
memory locations $0000 through $3FFFwill now contain $3F. 

In debugging a new program, it is often desireable to store 
$3F (software interrupt) in all your memory prior to loading 
and executing the program. If the program inadvertantly 
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transfers outside the program area, it will encounter a 
software interrupt, display the CPU registers and return 

to SMARTBUG. This command can also be used to clear blocks 
of memory by storing "00" into specified areas of memory. 


"Q" QUICKSTART 


This command is for the convenience of those people using the 
SMOKE SIGNAL BROADCASTING BFD-68 Disc System. Typing "Q" 
does the same thing as typing "J 8020". SMARTBUG transfers 
control to $8020 which is the beginning address of the 
routine that boots in the disc operating system from a 

cold start. 


"D" DISC 


Typing "D" transfers control from SMARTBUG to $7283 which 
is the warmstart address of DOS68, the disc operating 
system used with the BFD-68 disc system. This provides a 
convenient means of re-entering the DOS68 monitor from 
SMARTBUG when DOS68 has previously been booted in from disc 
and is resident in memory. Those people using the optional 
version of DOS68 located between D000 and DFFF will want to 
re-program the 2708 and change location $E3DF from $72 to 
$D2. Typing "D" will then trasfer program control to $D283 
which is the warmstart address of the optional version of 
DOS68. 


"E" ECHO, "“N" NO-ECHO, "H" HARDCOPY 


RAM location $A00B is a "flag" location that determines 
whether INEEE will echo back characters typed on the terminal 
and whether OUTEEE will output to the system terminal con- 
nected to I/O port number 2 (ACIA at $8008 and $8009) or 

jump to an external output routine. The external output 
routine would normally be a routine to drive a hardcopy 
printer. INEEE is a subroutine located at SEI1AC that waits 
for a character input from the system console and returns 
that character input in the A accumulator. OUTEEE is located 
at $E1D1 and causes a character in the A accumulator to be 
transmitted to the system console (or to the external print 
routine). | 


When hitting "RESET" or otherwise entering SMARTBUG at $EODO, 
location SA00B is cleared. Typing an "E" will also clear 
this location. When location $A00B contains a "00", all 
input through INEEE will be echoed through the system console 
and calls to OUTEEE will result in output to the system 
console and not a jump to an external printer output routine. 


NOTE: Many programs have been written that re-enter MIKBUG 
upon completion of the program at "START" location $EODO. 
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Normally, it is better to re-enter MIKBUG or SMARTBUG at 
“CONTRL" location $E0E3. Entering at "CONTRL" will not 
re-initialize SA00B to the ECHO mode, but will leave it in 
the mode last selected by the user or the user's program. 
This is usually more desireable. While MIKBUG does not 
have an echo control feature, there are some other reasons 
why it is usually better to re-enter MIKBUG or SMARTBUG 

at SEOE3 rather than SEODO. Also, remember that hitting 
"RESET" restores the echo. Unless this is your desired 
mode of operation, you will have to type "N" or "H" after 
pressing "RESET". 


Any positive number ($01 through $7F) stored in $A00B will 

' cause INEEE not to echo the character inputted through INEEE 
and OUTEEE will not jump to an external print routine. 

Typing "N" stores a $4E in location SAO0B and, thus, suppresses 
the echo. 


Any negative number ($80 through $FF) stored in $A00B will 
cause OUTEEE to jump to $A04A before anything is transmitted 
to the terminal device. Typing "H" stores a $B8 in location 
$A00B and, therefore, will cause OUTEEE to jump to SA04A. 
Any user wishing to use the "H" command will have to put 

a jump to his printer routine location in location $A04A, 
$A04B and $A04C prior to using this feature. Those SMARTBUG 
users having a SMOKE SIGNAL BROADCASTING P-38 series EPROM 
board will probably want to put their printer routine in 
EPROM. Then the printer routine will always be available 
without having to load it into RAM each time the system is 
powered up. The next EPROM location available on the P-38 
board is $E400 through SE7FF. We suggest standardizing on 
$E600 as the beginning location of the print routine. This 
leaves $E400 through SE5FF available for extended monitor 
routines. If you do put your printer routine at $E600, 

you will probably want to change SMARTBUG location $E1D7 
from $A0 to SE6 and location $E1D8 from $4A to $00. This 
will cause OUTEEE to jump directly to your routine at $E600 
instead of to $A04A. This again points out the advantage of 
having the system monitor in EPROM rather than ROM. With 
EPROM, it is easy to customize the system monitor to your 
unique system requirements. 


If you want OUTEEE to output both to the system console 
as well as to your separate hardcopy device when in the 
"H" mode, your print routine should end with a jump to 
SE1D9. Otherwise, it should end with a "RTS" ($39). 


CONTROL OF THE ECHO FUNCTION FROM THE USER'S PROGRAM 


Several programs such as BASIC and DOS68 turn the MIKBUG 

echo off prior to jumping to INEEE and restore the echo 

upon return. This allows the program to echo control charac-. 
ters and other normally non-printable characters. This is 
also probably the only major area where SMARTBUG and MIKBUG 
are not compatible. In MIKBUG, the echo is suppressed by 
storing a $3C in location $8007 and is restored by storing 
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$34 in location $8007. Running a program that suppresses 

the MIKBUG echo in SMARTBUG without first modifying the 

echo handling routine will result in the input being double 
echoed unless you type a "N" prior to entering these programs. 
For frequently used programs, it will probably be more 
convenient to modify them than to remember to type "N". 


To modify an existing program, we suggest that you change 
the instructions storing a $3C in $8007 to an "INC S$A00B" 
(7C AO OB) and that the instruction storing a $34 in $8007 
be changed to a "DEC S$A00B" (7A AO OB). NOP's ($01) should 
be used to fill in the extra area used by the previous in- 
structions. 


In DOS68, the echo control is found in the ZLINEI routine. 
The jump to ZLINEI is found in the jump table at $72B5 
(or $D2B5). Echo is turned off by the instruction sequence 
86 3C B7 80 07 and turned back on by the sequence 86 34 B7 
80 07. These sequences should be changed to 7C AO OB 01 O01 
and 7A AO OB 01 01 respectively. The exact location of 
the ZLINEI routine may vary with different versions of DOS68, 
but the jump table location will remain the same. This is 
why we ask you to go to the jump table to find ZLINEI and 
search through ZLINEI for this instruction sequence rather 
than specify the locations to be changed. 


By using an increment-decrement scheme to control the echo, 

the user now has control of the echo even if he has selected 

the "H" HARDCOPY function prior to entering his program. 

The first part of the printer routine should test to see if 

$A00B contains a $B8. If it does, the routine should output data 
given it. If it contains a $B9, the routine should do a 

"RTS" without outputting the data. 


"Pp" PUNCH FORMATTED TAPE 
EXAMPLE: *P 0100 0150 


The above example will cause SMARTBUG to punch a formatted 
tape containing the data in memory locations $0100 through 
$0150. The tape format is the same as the MIKBUG format and 
S9 is not punched at the end. This way, several areas of 
memory may be punched on one tape and loaded with one "L" 
command. At the end of the last area of memory to be punched 
to the tape, the user should manually type a S9 to the tape 
so that the "L" command will function automatically. 


"L" LOAD FORMATTED TAPE 


Typing "L" will turn on the system tape reader and read 
formatted tape produced by the "P" command. If the tape does 
not contain a $9 as an end of file indicator, it will be 
necessary for the user to manually type a S9 on the system 
console after the tape has been read in order to return to 
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SMARTBUG. The S9 causes SMARTBUG to be entered at "CONTRL". 
This is to be preferred over hitting "RESET" which causes 
entry at "START". 


Unlike MIKBUG, SMARTBUG normally echoes the tape input. 
If the user wishes to suppress the echo when loading tape, 
he should type "N" prior to typing "L". 


"4" JUMP TO SE400 


Typing a "4" will cause SMARTBUG to jump to $E400. This 
command allows users of the SMOKE SIGNAL BROADCASTING P-38 
series boards to expand their SMARTBUG monitor to include 
additional commands by installing another 2708 EPROM in the 
SE400 through S$E7FF socket on the board. The user can 
accomodate additional commands by having a routine starting 
at $E400 that asks for an additional character input and 
then executes whatever command is specified by that second 
character. Using this approach, all regular SMARTBUG commands 
would continue to be one character commands and all extended 
commands would be two character commands with the number "4" 
being the first character. 


We would very much appreciate a copy of any extended commands 
you may develop. Naturally, we would prefer a fully-commented 
source listing; however, don't be embarrassed to send just 

the object code along with a brief functional description. 
After all, it seems most of us write programs first and 
document them later (and then, only if absolutely necessary). 


"K" BREAKPOINT 


The "K" command is a tool to allow the programmer to step 
through his program a few steps at a time in order to 

inspect his program at these intermediate steps to see if 

the program is, indeed, operating as it was so carefully 
designed to do. To use the "K" command, first load the 
starting address of the program into memory locations $A048 
and $A049 using the "M" command. Next decide where you 

want the first breakpoint. Then type "K" followed by the 
four hex digits representing the address at which the 
breakpoint is to be inserted. After entering the fourth 
digit, SMARTBUG will jump to the location previously stored 
in $A048 and $A049 and execute the program until it encounters 
the breakpoint (if it ever does). When the breakpoint 

is encountered, SMARTBUG will display the contents of the 
registers in the same format as the "R" command. To continue 
the program at the point it was interrupted, simply type 

"G". To pick up at this point and continue to a second 
breakpoint, type "K" followed by a new breakpoint address. 


SMARTBUG uses the "SWI" ($3F) instruction to set a breakpoint; 
thus, a breakpoint may not be set in an area of Read-Only- 
Memory. SMARTBUG remembers the instruction stored in the 
breakpoint location and automatically restores that instruction 
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after encountering the breakpoint. If the program "gets 
lost" and the breakpoint is not encountered, the instruction 
will not be restored and will have to be manually restored 
by the user. 


"T" TRACE MODE 


Typing a "T" followed by a four digit hexadecimal address 
puts SMARTBUG in the single-step trace mode. This allows 
the user to step through a program in RAM one step at a 
time and to examine and change the registers after each 
step. Stepping to a ROM location will cause SMARTBUG to 
return to the regular command mode and prompt with an asterisk. 
After typing "T" followed by four hex digits, SMARTBUG 

will type the current contents of the registers followed 

by the specified address and the command to be executed at 
that address. No asterisk prompt character is issued which 
indicates that SMARTBUG is in the TRACE mode. Prior to 
executing the next instruction, the user may change the 

A, B, C or X registers with the A, B, C or X commands. 

When ready to execute the next instruction, hit the SPACE BAR. 
To return to the regular SMARTBUG mode, hit the carriage 
return. Following is the trace output from a very short 
program. 


MEMORY CONTENTS: 0100 86 
0101 43 
0102 BD 
0103 O1 
0104 Dl 
0105 86 
0106 55 
0107 3F 
01D1 39 


*T 0100 

FO 33 00 E26E 0100 A049 
0100 86 43 

SPACEBAR 

FO 33 43 E26E 0102 A049 
0102 BD O1D1 

SPACEBAR 

FO 33 43 E26E 01D1 A047 
01D1 39 

B 33 48 

SPACEBAR 

FO 48 43 E26E 0105 A049 
0105 86 55 

SPACEBAR 

FO 48 55 E26E 0107 A049 
0107 3F 


ee ane: 


The format for the listing of the register contents is the 
same as in the "R" command. 
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IRQ AND NMI 


If the system encounters an IRQ interrupt request, it will 
jump to the location contained in memory locations $A000 and 
$A001. An NMI interrupt will cause SMARTBUG to jump to the 
location contained in memory locations $A006 and $A007. If 
the user anticipates these types of interrupts, he should 
initialize these locations early in his program. Alternately, 
he can re-program the vector locations in SMARTBUG to go 

to permanent interrupt handling routines in his system. 


COMPATIBILITY WITH MIKBUG 


Every reasonable effort was made to keep the subroutines 

in SMARTBUG at the same beginning address locations as 

the functionally equivalent subroutines in MIKBUG so that 
programs written for MIKBUG would run in SMARTBUG without 
modification. As shown in the list below, all the locations 
of the most frequently used routines are maintained. 


THE FOLLOWING LABELS IN SMARTBUG ARE FUNCTIONALLY EQUIVALENT 
TO THOSE IN MIKBUG AND ARE LOCATED AT THE SAME ADDRESS LOCATIONS. 


Io POWDWN LOAD LOAD3 LOAD11 LOAD15 
LOAD 19 LOAD21 Cl BADDR BYTE OUTHL 
OUTHR OUTCH INCH PDATA2 PDATA1 CHANGE 
CHA5S1 INHEX IN1LHG ' OUT 2H OUT2HA OUT4HS 
OUT2HS OUTS START CONTRL SFE INEEE 
OUTEEE IOV BEGA ENDA NIO SP 

XHI XLOW TEMP TW XTEMP STACK 


THE FOLLOWING LOCATIONS IN MIKBUG ARE NOT FOUND AT THE SAME 
LOCATIONS IN SMARTBUG AND THERE MAY BE NO FUNCTIONALLY 
EQUIVALENT LABEL IN SMARTBUG. 


PRINT C2 MTAPE1 PUNCH PUN11 PUN22 
PUN23 PUN32 PUNT2 MCLOFF MCL SAV 
IN1 IN3 IouT OUT1 IOUT2 Ios 
DEL DE CKSM BYTECT MCONT 


LIMITED. WARRANTEE 


Any purchaser of SMARTBUG who is not satisfied with its 
performance may return his copy within 10 days from date 

of purchase for a full refund. This warrantee is in lieu 

of all other warrantees express or implied. SMOKE SIGNAL 
BROADCASTING does not warrant the suitability of SMARTBUG 

for any particular user application and will not be responsible 
for damages incidental to its use in a user system. 
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LICENSE CONDITIONS 


Purchase of a P-38 series board which includes SMARTBUG or 
purchase of a SMARTBUG listing conveys to the purchaser a 
license to copy SMARTBUG for his own use, and not for sale 
or free distribution to others. No other license, express 
or implied, is conveyed. 


LIMERICK 


Mary had a little plane. 
She flew it high and brisk. 
Wasn't she a silly girl, 
her little * 


USER CONTRIBUTIONS 


Any user wishing to contribute program or limerick improvements 
should send them to: 


SMOKE SIGNAL BROADCASTING 
P.O. BOX 2017 
HOLLYWOOD, CA 90028 


We are particularly interested in extended monitor commands 
for possible inclusion in a future 2K or 4K monitor program. 
Worthwhile contributions will also be published in future 
newletters with credit to the author. 
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PAGE 001 SMARTBUG 

00100 NAM SMARTBUG 

00120 * “"SMARTBUG" - AN INTELLIGENT MONITOR 
00130 * COPYRIGHT 1977 SMOKE SIGNAL BROADCASTING 
00150 OPT 0,5 

00160 8008 ACIAS EQU $8008 

00170 8009 ACIAD EQU $8009 

00180 E000 ORG $E000 

00200 * I/O INTERRUPT SEQUENCE 

00210 E000 FE AOOO IO LDX IOV 

00220 E003 6E 00 JMP X 

00240 * NMI SEQUENCE 

00250 E005 FE A006 POWDWN LDX NIO GET NMI VECTOR 
00260 E008 6E 00 JMP X GO TO NMI LOCATION 


00280 

00290 EOOA LOAD EQU 
00300 EOOA 86 55 LDA A 
00310 EOOC B7 8008 STA A 
00320 EOOF 8 11 LDA A 
00330 E011 8D 62 BSR 
00340 E013 8D 63 LOAD3 BSR 
00350 E015 81 53 CMP A 
00360 E017 26 FA BNE 
00370 E019 8D 5D BSR 
00380 E01B 81 39 CMP A 
00390 EOID 27 25 BEQ 
OO400 EOIF 81 31 CMP A 
00410 E021 26 FO BNE 
00420 E023 7F AOG6A CLR 
00430 E026 8D 2D BSR 
OO440 E028 80 02 SUB A 
00450 E02A B7 A06B STA A 


#855 
ACIAS 
#$11 
OUTCH 
INCH 
#'°S 
LOAD3 
INCH 
#'9 
LOAD21 
#"1 
LOAD3 
CKSM 
BYTE 
#2 
BYTECT 


00460 * BUILD ADDRESS 
00470 E02D 8D 18 BSR BADDR 
00480 # STORE DATA 

00490 EQ2F 8D 24 LOAD11 BSR BYTE 
00500 £031 7A AO06B DEC  BYTECT 
00510 E034 27 05 BEQ LOAD15 
00520 E036 A7 00 STA A X 
00530 £038 08 INX 

00540 E039 20 F4 BRA LOAD11 
00550 E03B 7C AO6A LOAD15 INC  CKSM 
00560 EO3E 27 D3 BEQ  LOAD3 
00570 EONO 86 3F LOADI9 LDA A #'? 
00580 E042 8D 31 BSR  OUTCH 
00590 EOu4 LOAD21 EQU # 
00600 E044 7E EOE3 C1 JMP §CONTRL 
00620 # BUILD ADDRESS 


00630 EOX7 8D OC BADDR BSR i 


* LOAD ASCII FORMATTED TAPE 


READER RELAY ON, ONE STOP BIT 


AC-30 READ CTRL 

GET CHARACTER 

IS IT AN "S" 

NO-LOOP TILL "S" FOUND 
YES = GET NEXT CHARACTER 
IS IT A "9" 

YES - JUMP TO CONTROL 
IS ITA "1" 

NO ~ TRY AGAIN 

YES - ZERO CHECKSUM 
GET A BYTE 


READ THIS MANY BYTES 


READ NEXT BYTE 
DECREMENT BYTE COUNTER 
IF 0, GET NEXT LINE 


_ ELSE, STORE DATA 


' FORM 2'S COMPLEMENT 


IT SHOULD BE ZERO 
READ ERROR - PRINT 
QUESTION MARK 


READ 2 BYTES 
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00640 EONS B7 AOOC STA A 
00650 EOHC 8D 07 BSR 
00660 EOXE B7 AOOD STA A 
00670 E051 FE AOOC LDX 
00680 E054 39 RTS 
00700 

00710 E055 8D 53 BYTE BSR 
00720 E057 48 ASL A 
00730 E058 48 ASL A 
00740 E059 48 ASL A 
00750 E05A 48 ASL A 
00760 E05B 16 TAB 
00770 EO5C 8D 4C BSR 
00780 EO5E 1B ABA 
00790 E05F 16 TAB 
00800 £060 FB AO6A ADD B 
00810 E063 F7 AO6A STA B 
00820 E066 39 RTS 
00840 E067 44 OUTHL LSR A 
00850 E068 44 LSR A 
00860 E069 44 LSR A 
00870 EO6A 44 LSR A 
00890 EO6B 84 OF OUTHR AND A 
00900 EO6D 8B 30 ADD A 
00910 EO6F 81 39 CMP A 
00920 E071 23 02 BLS 
00930 E073 8B 07 ADD A 
00940 E075 7E E1D1 OUTCH JMP 
00950 E078 7E E1AC INCH JMP 


00970 


00980 EO7B 8D F8 PDATA2 BSR 


00990 EO7D 08 
01000 EO7E A6 00 


INX 


XHI 
BYTE 
XLOW 
XHI 


INHEX 


INHEX 


CKSM 
CKSM 


#$F 
#$30 
#$39 
OUTCH 
#7 
OUTEEE 
INEEE 


OUTCH 


PDATA1 LDA A X 


01010 E080 81 04 CMP A #4 
01020 E082 26 F7 BNE PDATA2 
01030 E084 39 RTS 

01050 * CHANGE MEMORY 
01060 E085 8D CO CHANGE BSR BADDR 
01070 E087 CE E3F1 CHAD51 LDX #MCL 
01080 EO8A 8D F2 BSR PDATA1 
01090 EO8C CE AOOC LDX #XHT 
01100 EO8F 8D 37 BSR OUT4HS 
01110 E091 FE AOOC LDX XHI 
01120 E094 8D 34 BSR OUT2HS 
01130 E096 FF AOOC STX XHI 
01140 E099 8D DD BSR INCH 
01150 EO9B 81 20 CMP A #$20 
01160 EO9D 27 E8 BEQ CHA51 
01170 EOOF 7E E3AD JMP TDEX 


AND RETURN FROM THIS 
SUBROUTINE WITH BOTH 
BYTES IN THE INDEX 
REGISTER. 


* INPUT BYTE (2 HEX CHARACTERS) 


GET 1ST HEX CHAR 


GET 2ND HEX CHAR 


UPDATE CHECKSUM AND 
RETURN WITH BYTE IN 
A ACCUMULATOR 


OUT HEX LEFT BCD DIGIT 


OUT HEX RIGHT BCD DIGIT 


OUTPUT A CHARACTER 
INPUT A CHARACTER 


* PRINT DATA POINTED TO BY INDEX REGISTER 


END OF STRING CHARACTER 


GET MEMORY ADDRESS 


PRINT C/R L/F 
PRINT ADDRESS 
PRINT OLD DATA 
INPUT A CHARACTER 
IF IT'S A SPACE 


GET NEXT ADDRESS 
ELSE - GO TO TDEX 
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01190 EOA2 A7 00 CHA61 


01200 EOA4 A1 00 
01210 EOA6 27 DF 
01220 EOA8 20 96 


01240 

01250 EOAA 8D CC 
01260 EOAC 80 30 
01270 EOAE 2B 94 
01280 EOBO 81 09 
01290 EOB2 2F OA 
01300 EOB4 81 11 
01310 EOB6 2B 8C 
01320 EOB8 81 16 
01330 EOBA 2E 88 
01340 EOBC 80 07 
01350 EOBE 39 


01370 EOBF A6 00 
01380 EOC1 8D A4 
01390 EOC3 A6 00 
01400 E0C5 08 

01410 E0C6 20 A3 


01430 EOC8 8D F5 
01440 EOCA 8D F3 
01450 EOCC 86 20 
01460 EOCE 20 A5 


01480 


01490 EODO 


01500 EODO 8E A042 
01510 EOD3 BF A008 
01520 EOD6 7F AOOB 


01530 EOD9 86 03 


01540 EODB B7 8008 


01550 EODE 8 15 


01560 EOEO B7 AOOA INZ1 


SMARTBUG 


01570 EOE3 B6 AOOA CONTRL LDA A 


01580 EOE6 B7 8008 
01590 EOE9 8E AON2 
01600 EOEC 7F A011 
01610 EOEF CE E3F0 


01620 EOF2 8D 8A 
01640 EOF4 8D 82 


01650 EOF6 7F A014 


01660 EOF9 16 
01670 EOFA 8D DO 


01680 EOFC CE E3C3 


01690 EOFF E1 00 
01700 E101 27 OB 
01710 E103 08 
01720 E104 08 


STA A X 

CMP A X 

BEQ CHA51 

BRA LOAD19 
* INPUT HEX CHARACTER 
INHEX BSR INCH 

SUB A_ #$30 

BMI C1 

CMP A #9 

BLE IN1HG 

CMP A #$11 

BMI C1 

CMP A #$16 

BGT C1 

SUB A #7 
IN1HG RTS 
OUTCH LDA A X 
OUT2HA BSR OUTHL 

LDA A X 

INX 

BRA OUTHR 
OUT4HS BSR OUTH 
OUT2HS BSR OUT2H 
OUTS LDA A #$20 

BRA OUTCH 
* POWER ON SEQUENCE 
START EQU . 

LDS #STACK 

STS SP 

CLR ECHO 

LDA A #3 

STA A ACIAS 
INZ LDA A #$15 

STA A ACIAT 

ACIAT 

STA A ACIAS 

LDS #STACK 

CLR TFLAG 

LDX #MCLOFF 

BSR PDATA1 

BSR INCH 

CLR BKFLG 

TAB 

BSR OUTS 

LDX #FUTABL 
NXTCHR CMP B 0,X 

BEQ GOODCH 

INX 

INX 


STORE NEW DATA 

DID IT STORE CORRECTLY? 
YES - GET NEXT ADDRESS 
NO = JUMP CONTROL 


NOT HEX, JUMP CONTROL 


NOT HEX 
NOT HEX 


OUTPUT 2 HEX CHAR 
OUT LEFT HEX CHAR 


OUTPUT RIGHT HEX CHAR 
OUTPUT 4 HEX CHAR AND SPACE 


- QUTPUT 2 HEX CHAR AND SPACE 


OUTPUT SPACE 


ECHO ALL INPUT CHARACTERS 
MASTER RESET OF ACIA 


SET UP FOR 1 STOP BIT 


ALLOW FOR SOFTWARE CONTROL 
OF ACIA CONTROL REGISTER 


TURN OFF TRACE MODE 


INPUT COMMAND CHARACTER 
CLEAR BREAKPOINT INDICATOR 


DO TABLE LOOKUP 

FOR COMMAND FUNCTIONS 

MATCH FOUND 

NO MATCH=-INC TO NEXT COMMAND 
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01730 E105 08 INX 
01740 E106 8C E3FO CPX 
01750 E109 26 F4 BNE 
01760 E10B 7E E2D9 JMP 
01770 E10E EE 01 GOODCH LDX 
01780 E110 6£ 00 JMP 
01790 E112 01 NOP 


#TBLEND END OF COMMAND TABLE? 


NO - GET NEXT CHARACTER 

YES - CHECK FOR A,B,C,X CMNDS 
GET COMMAND LOCATION 

AND JUMP THERE 

KEEP SFE AT $E113 


SAVE PROGRAM'S STACK POINTER 


IF TRACE IS OFF 


01810 # ENTER FROM SOFTWARE INTERRUPT 
01820 E113 BF A008 SFE STS SP 

01830 * DECREMENT PROGRAM COUNTER 
01840 E116 30 TSX 

01850 E117 6D 06 TST  6,X 

01860 E119 26 02 BNE = ®&+j 

01870 E11B 6A 05 DEC 5,X 

01880 E11D 6A 06 DEC 6,X 

01890 E11F 7D A011 TST  TFLAG 

01900 E122 27 63 BEQ  PRNT 

01910 E124 7E E38C JMP —- SWTURN 


IF TRACE IS ON 


01930 * PUNCH = OUTPUT HEX FORMATTED TAPE 

01950 E127 8D 74 PUNCH BSR LIMITS GET LIMITS 

01960 E129 86 12 LDA A #$12 AC-30 CONTRL 

01970 E12B BD E075 JSR. OUTCH 

01980 E12E FE A002 LDX BEGA THE "P" COMMAND JUMPS TO 
01990 E131 FF AOOF STX TW PUNCH AFTER USING THE LIMITS 
02000 E134 B6 A005 PUN11 LDA A ENDA+1 SUBROUTINE TO ENTER THE 
02010 E137 BO A010 SUB A TW+1 START AND STOP ADDRESSES 
02020 E13A F6 AOO4 LDA BENDA 

02030 E13D F2 AOOF SBC B TW 

02040 E140 26 04 BNE PUN22 

02050 E142 81 10 CMP A #16 

02060 E144 25 02 BCS PUN23 

02070 E146 86 OF PUN22 LDA A #15 

02080 E148 8B O4 PUN23 ADD A #4 

02090 E14A B7 A064 STA A MCONT FRAME COUNT THIS RECORD 
02100 E14D 80 03 SUB A #3 

02110 E14F B7 AOOE STA A TEMP BYTE COUNT THIS RECORD 
02120 * PUNCH C/R,L/F,NULL,S,1 

02130 E152 8D 77 BSR CRLF 

02140 E154 08 INX 

02150 E155 8D 77 BSR PDAT1 

02160 E157 5F CLR B ZERO CHECKSM 

02170 * PUNCH FRAME COUNT 

02180 E158 CE A064 LDX #MCONT 

02190 E15B 8D 25 BSR PUNT2 PUNCH 2 HEX CHAR 

02200 * PUNCH ADDRESS 

02210 E15D CE AOOF LDX #TW 

02220 E160 8D 20 BSR PUNT2 

02230 E162 8D 1E BSR PUNT2 

02240 * PUNCH DATA 

02250 E164 FE AOOF LDX TW 

02260 E167 8D 19 PUN32 BSR PUNT2 PUNCH ONE BYTE 
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02270 E169 7A AOOE DEC TEMP DECREMENT ONE BYTE 
02280 E16C 26 F9 BNE PUN32 

02290 E16E FF AOOF STX TW 

02300 E171 53 COM B 

02310 E172 37 PSH B 

02320 E173 30 TSX . 

02330 E174 8D OC BSR PUNT2 PUNCH CHECKSUM 
02340 E176 33 PUL B RESTORE STACK 
02350 E177 FE AOOF LDX TW 

02360 E17A 09 DEX 

02370 E17B BC A004 CPX ENDA 

02380 E17E 26 BA BNE PUN11 

02390 E180 20 47 BRA C3 GO TO CONTROL 
02400 E182 EB 00 PUNT2 ADD B X 

02410 E184 7E EOBF JMP OUT2H 


02420 E187 20 61 PRNT~ BRA PRINT 
02440 E189 8D 36 BKPNT BSR BAD2 GET BREAKPOINT ADDRESS 


02450 E18B FF A068 STX PB2 

02460 E18E A6 00 LDA A X SAVE INSTRUCTION AND 
02470 E190 B7 A014 STA A BKFLG SET BREAKPOINT FLAG 

02480 E193 86 3F LDA A #$3F 

02490 E195 A7 00 STA A X SET BREAKPOINT 

02500 E197 8D 32 BSR CRLF 

02510 E199 BE A008 CONTG LDS SP RESTORE PGM'S STACK POINTER 
02520 E19C 3B RTI GO TO USER'S PROGRAM 
02540 E19D 8D 22 LIMITS BSR BAD2 GET FIRST ADDRESS 

02550 E19F FF A002 STX BEGA 

02560 E1A2 8D 05 BSR OUS OUTPUT A SPACE 

02570 E1A4 8D 1B BSR BAD2 GET SECOND ADDRESS 

02580 E1A6 FF AOO4 STX ENDA 

02590 E1A9 7E EOCC OUS JMP OUTS OUTPUT A SPACE & RETURN 
02610 * INPUT ONE CHARACTER INTO A ACCUMULATOR 

02620 E1AC B6 8008 INEEE LDA A ACIAS TEST RECEIVE DATA REG FULL 
02630 E1AF 47 ASR A _ FLAG AND LOOP TILL IT IS SET 
02640 E1BO 24 FA BCC INEEE 

02650 E1B2 B6 8009 LDA A ACIAD GET DATA 

02660 E1B5 84 7F AND A #$7F ELIMINATE PARITY BIT 

02670 E1B7 81 7F CMP A #$7F 

02680 E1B9 27 F1 BEQ INEEE IGNORE RUBOUTS 

02690 E1BB 7D AOOB TST ECHO 

02700 E1BE 2F 11 BLE OUTEEE 

02710 E1CO 39 RTS 

02730 E1C1 7E EO47 BAD2 JMP BADDR GET ADDRESS 

02750 E1C4 5F ECHON CLR B ECHO ALL INPUT CHARACTERS 
02760 E1C5 50 PRNTON NEG B TURN PRINTER ON 

02770 E1C6 F7 AOOB ECHOFF STA B_ ECHO DO NOT ECHO 

02780 E1C9 20 41 C3 BRA C2 GO TO CONTROL 


02800 E1CB CE E3A4 CRLF LDX #CRLFAS C/R L/F WITHOUT * PROMPT 
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02810 E1CE 7E EO7E PDAT1 JMP PDATA1 SIGNIFIES TRACE MODE 


02830 * OUTPUT ONE CHARACTER FROM A-REG 

02840 E1D1 7D AOOB OUTEEE TST ECHO IF ECHO IS NEGATIVE, 
02850 E1D4 2C 03 BGE OUTCH2 GO TO PRINTER ROUTINE. 
02860 E1D6 7E AOMA JMP PRINTR 

02870 E1D9 37 OUTCH2 PSH B 

02880 E1DA F6 8008 OUTCH1 LDA B ACIAS TEST TRANSMIT DATA 
02890 E1DD 57 ASR B REGISTER EMPTY FLAG 
02900 EIDE 57 ASR B AND LOOP TILL SET 
02910 E1DF 24 F9 BCC OUTCH1 

02920 E1E1 B7 8009 STA A ACIAD OUTPUT DATA TO ACIA 
02930 E1E4 33 PUL B RESTORE B-REG 

02940 E1E5 39 RTS 

02960 E1E6 8D D9 JUMP’ BSR BAD2 GET LOCATION OF JUMP 


02970 E1E8 6E 00 IMP X GO TO USER'S PROGRAM 
02990 # PRINT CONTENTS OF STACK 

03000 E1EA FE A008 PRINT LDX SP 

03010 E1ED 08 INX 


03020 E1EE 8D 44 BSR OUT2 CONDITION CODES 

03030 E1FO 8D 42 BSR OUT2 B ACCUMULATOR 

03040 E1F2 8D 40 BSR OUT2 A ACCUMULATOR 

03050 E1F4 8D 3C BSR OUTT4 INDEX REGISTER 

03060 E1F6 8D 3A BSR OUTT4 PROGRAM COUNTER 

03070 E1F8 CE A008 LDX #SP 

03080 E1FB 7D A011 TST TFLAG 

03090 E1FE 26 21 BNE PRINTS IF IN TRACE MODE 

03100 E200 8D 30 BSR OUTT4 STACK POINTER 

03110 E202 B6 A014 LDA A BKFLG GET INSTR TO REPLACE BKPNT 
03120 E205 27 05 BEQ C2 NO BREAKPOINT SET 

03130 E207 FE A068 LDX PB2 

03140 E20A A7 00 STA A X REPLACE BREAKPOINT 

03150 E20C 7E EOE3 Ce JMP CONTRL 

03170 E20F 8D 8C IFILL BSR LIMITS GET START & END ADDRESSES 
03180 E211 8D 7F BSR BYT GET DESIRED CONTENTS 
03190 E213 FE A002 LDX BEGA 1ST ADDRESS TO INDEX REG 
03200 E216 09 DEX 

03210 E217 08 FILLOP INX 

03220 E218 A7 00 STA A X FILL MEMORY FROM A REG 
03230 E21A BC AOO4 CPX ENDA 

03240 E21D 26 F8 BNE FILLOP LOOP UNTIL DONE 

03250 E21F 20 EB C5 BRA C2 GO TO CONTROL 

03270 E221 E6 00 PRINTS LDAB X WHEN IN TRACE MODE 

03280 E223 A6 01 LDA A 1,X DISPLAY S-POINTER THAT 
03290 E225 8B 07 ADD A #7 WILL BE USED WHEN EXECUTING 
03300 E227 C9 00 ADC B #0 THE DISPLAYED INSTRUCTION 
03310 E229 F7 AOOE STA B TEMP 

03320 E22C B7 AOOF STA A TEMP+1 

03330 E22F CE AOOE LDX #TEMP 

03340 E232 20 63 OUTT4Y BRA OUT4 
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03350 


03370 
03380 
03390 
03400 
03410 
03420 
03430 
03440 
03450 
03460 
03470 
03480 
03490 
03500 
03510 
03520 
03530 
03540 
03550 
03560 
03570 
03580 
03590 
03600 
03610 
03620 
03630 
03640 
03650 
03660 
03670 
03680 
03690 
03700 
03710 
03720 
03730 
03740 
03750 
03760 
03770 
03780 
03790 
03800 
03810 
03820 
03830 
03840 
03850 
03860 


007 


E234 7E EOCA 


E237 8D 88 
E239 8D 90 
E23B FE A008 
E23E F6 AOOC 
E241 E7 06 
E243 B6 AOOD 
E246 A7 07 
E248 7C A011 
E24B 8E A060 
EQUE 8D 9A 
E250 7F A065 
E253 FE A008 
E256 EE 06 
E258 FF AOOC 
E25B BD E1CB 
E25E CE AOOC 
E261 8D 34 
E263 FE AOOC 
E266 E6 00 


E287 C4 
E289 C1 
E28B 26 
E28D 7C 
E290 20 
E292 TE E055 
E295 20 88 
E297 7E EOC8 
E29A C1 60 
E29C 25 OC 
E29E C4 30 
E2A0 C1 30 
E2A2 26 04 
E2A4 8D F1 
E2A6 20 02 
E2A8 8D 8A 


SMARTBUG 


OUT2 


JMP 


OUT2HS 


* TRACE ROUTINE 


TRACE 


RETURN 


BYT 
C4 
OUT4 
NOTB 


BYT3 
BYT2 


03870 E2AA FF AOOC BYT1 
* XHI NOW CONTAINS NEXT INS LOCATION 


03880 


BSR 


STX 


BAD2 
CRLF 


XHI 


GET START ADDRESS OF TRACE 
AND SAVE IN XHI & XLOW 


PUT START ADDRESS IN 
PROGRAM COUNTER POSITION 
IN STACK 


SET TRACE FLAG 

SEPARATE STACK FOR TRACE 
DISPLAY ALL REGISTERS 
CLEAR BRANCH FLAG 


GET PROGRAM COUNTER FROM STAC 
AND SAVE IN XHI AND XLOW 


DISPLAY PROGRAM COUNTER 
AND FIRST BYTE OF 
INSTRUCTION 


STORE 2ND BYTE OF INSTRUCTION 
IN PB2 AND 3RD BYTE IN PB3 
IF INSTRUCTION IS LONGER 
THAN ONE BYTE 

BSR? TEST FOR SPECIAL CODES 
CPX? 

LDS? 

LDX? 

TEST FOR RELATIVE BRANCH 
TYPE INSTRUCTIONS 

SET BRANCH FLAG 

TWO BYTE INSTRUCTION 

GO TO CONTROL 

IS CODE LESS THAN 60? 

YES - 1 BYTE INSTRUCTION 
ONLY 3 BYTE WILL FALL THRU 
DISPLAY 2 BYTE OPERAND 


DISPLAY 1 BYTE OPERAND 
SAVE LOCATION OF NEXT INSTR 
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03890 E2AD 7D A065 TST 
03900 E2B0 27 19 BEQ 
03910 E2B2 4F CLR A 
03920 E2B3 F6 A068 LDA B 


03930 E2B6 2C 02 BGE 


03940 E2B8 86 FF LDA A 
03950 E2BA FB AOOD DPOS ADD B 
03960 E2BD B9 AOOC ADC A 
03970 E2CO B7 A061 STA A 
03980 E2C3 F7 A062 STA B 
03990 E2C6 CE A061 LDX 
04000 E2C9 8D CC BSR 
04010 E2CB BD E1CB NOTBB JSR 
04020 E2CE BD E1AC JSR 
04030 E2D1 16 TAB 
O4040 E2D2 BD EOCC JSR 
04050 E2D5 Ci 20 CMP 
04060 E2D7 27 35 BEQ 
04070 E2D9 FE A008 CKCBA LDX 
04080 E2DC 08 INX 
04090 E2DD C1 43 CMP 
04100 E2DF 27 OA BEQ > 
04110 E2E1 08 INX 
04120 E2E2 C1 42 CMP B 
04130 E2E4 27 05 BEQ 
04140 E2E6 08 INX 
04150 E2E7 C1 41 CMP B 
04160 E2E9 26 OA BNE 
04170 E2EB BD EOCA RDC JSR 
04180 E2EE 09 DEX 
04190 E2EF 8D Al BSR 
04200 E2F1 A7 00 STA 
04210 E2F3 20 12 BRA 
04220 E2F5 C1 58 CHKX CMP 
04230 E2F7 26 9C BNE 
O424O E2F9 08 INX 
04250 E2FA 8D 9B BSR 
04260 E2FC 8D 94 BSR 
04270 E2FE FE A008 LDX 
04280 E301 AT O04 STA A 
04290 E303 8D 8D BSR 


04300 E305 A7 05 
04310 E307 7D AO11 RETDID TST 
04320 E30A 26 BF BNE 
04330 E30C 20 87 RETNOT BRA 


O4340 E30E C6 3F DOT LDA B 
04350 E310 B6 A067 LDA A 
04360 E313 81 8D CMP A 
04370 E315 26 OB BNE 
04380 E317 FE A061 LDX 
04390 E31A FF AOOC STX 
O4400 E31D 7F A065 CLR 
04410 E320 20 59 BRA 


04420 E322 7D A065 TSTB TST 


STA A 


IS IT A BRANCH? 
NO 
YES, COMPUTE TARGET LOCATION 


TEST FOR BRANCH BACK 

FF FOR BACKWARD BRANCH 
ADD OPERAND TO LOWER 

8 BITS OF PROGRAM COUNTER 
SAVE TARGET ADDRESS 


DISPLAY TARGET ADDRESS 


GET COMMAND 
SAVE IN B REGISTER 


IF SPACE EXECUTE THE 
INSTRUCTION. IF NOT A 
SPACE, TEST FOR A CHANGE 
REGISTER COMMAND. NOTE, THIS 
PART OF MEMORY IS SHARED 
WITH THE CHANGE REGISTER 
COMMANDS WHEN NOT IN TRACE 
MODE. IF IT IS A CHANGE 
REGISTER COMMAND WHILE IN 
TRACE MODE, RETURN TO 
NOTBB FOR NEXT COMMAND. 


DISPLAY REGISTER CONTENTS 
SAVED IN STACK 

GET NEW CONTENTS 

AND STORE IN STACK 


DISPLAY INDEX CONTENTS 
GET HIGH 8 BITS 


STORE IN STACK 

GET LOWER 8 BITS 

STORE 

IN TRACE? 

YES, GET NEXT TRACE CMD 
RETURN TO CONTROL 

SWI CODE TO B-REG 

GET INSTRUCTION 

IS IT A BSR? 

IF YES, NEXT INSTRUCTION 
WILL BE AT ADDRESS STORED 
IN BPOINT. 

ONLY ONE SWI NEED BE SET 
SET BKPOINT AND EXECUTE INST 
IS IT CONDITIONAL BRANCH? 
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04430 E325 27 OC BEQ TSTJ 
O4440 E327 FE A061 LDX _ BPOINT 
O4450 E32A A6 00 LDA A X 
04460 E32C B7 A063 STA A BPOINT+2 
04470 £32F ET 00 STAB X 
04480 E331 20 48 BRA EXEC 
04490 E333 81 6E TSTJ CMP A #$6E 
04500 E335 27 14 BEQ ISX 
04510 E337 81 AD CMP A #$AD 
04520 E339 27 10 BEQ ISX 
04530 £33B 81 7E CMP A #$7E 
O4540 E33D 27 04 BEQ  ISJ 
04550 E33F 81 BD CMP A #$BD 
04560 E341 26 1C BNE  NOTJ 
04570 £343 FE A068 ISJ. LDX  PB2 
04580 E346 FF AOOC STX  XHI 
04590 E349 20 30 BRA EXEC 
04600 E34B FE AOO8 ISX LDX SP 
04610 E34E A6 05 LDA A 5,X 
04620 E350 BB A068 ADD A PB2 
04630 E353 B7 AOOD STA A XLOW 
O4640 E356 A6 04 LDA A 4,X 
04650 E358 89 00 ADC A #0 
04660 E35A B7 AOOC STA A XHI 
04670 E35D 20 1C BRA EXEC 
O4680 E35F FE AQO8 NOTJ LDX SP 
04690 E362 81 39 CMP A #$39 
04700 E364 26 O4 BNE §-NOTRTS 
04710 E366 EE 08 LDX  8,X 
04720 E368 20 06 BRA —EXR 
04730 E36A 81 38 NOTRTS CMP A #$38 
O4740 E36C 26 05 BNE NOTRTI 
04750 E36E EE OD LDX  13,X 
04760 E370 FF AOOC EXR TX  XHI 
04770 E373 81 3F NOTRTI CMP A #$3F 
04780 E375 27 95 BEQ  RETNOT 
04790 E377 81 3E CMP A #$3E 
04800 E379 27 91 BEQ  RETNOT 
04810 E37B FE AOOC EXEC LDX  XHI 
04820 E37E A6 00 LDA A X 
04830 E380 B7 A066 STA A OPSAVE 
O4840 E383 E7 00 STAB X 
04850 E385 E1 00 CMP B X 
04860 E387 26 83 BNE - RETNOT 
04870 * EXECUTE INSTRUCTION 
04880 E389 7E E199 JMP —-CONTG 
04900 #RETURN HERE ON SWI IF 
04910 E38C FE AOOC SWITURN LDX XHI 
04920 E38F B6 A066 LDA A OPSAVE 
04930 E392 AT 00 STAA X 
ONQ4O E394 7D A065 TST  BFLAG 
04950 E397 27 08 BEQ  DISPLY 
04960 E399 FE A061 LDX _ BPOINT 


YES, SET BREAKPOINT AT 
TARGET ADDRESS IN CASE 
PROGRAM GOES THERE. 

SAVE INSTRUCTION 

SET SWI AT TARGET ADDRESS 


INDEXED JUMP INSTRUCTION? 
INDEXED JSR? 

STRAIGHT JUMP? 

STRAIGHT JSR? 


PUT NEXT INSTRUCTION 
ADDRESS IN XHI & XLOW 


COMPUTE NEXT INST ADDRESS 
FOR INDEXED JUMPS 


IS INSTRUCTION AN RTS? 
NO 


YES, PULL RETURN ADDRESS 
FROM STACK AND STORE IN 
NEXT INSTRUCTION POINTER. 


Swi? 

YES, RETURN TO CONTROL 

WAI? 

YES, RETURN TO CONTROL 

SET BREAKPOINT AT NEXT 
INSTRUCTION LOCATION AND SAVE 
OP CODE. 

STORE SWI AT BREAKPOINT & 
VERIFY THAT IT'S WITHIN RAM 
IF ROM, GO TO CONTROL 


RTI TO EXECUTE INSTRUCTION 
TRACE FLAG ON 

REPLACE SWI'S WITH PREVIOUS 
CONTENTS. IF BFLAG IS CLEAR, 


THEN ONLY ONE BREAKPOINT 
WAS SET. 
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04970 E39C B6 A063 


05010 


05030 
05040 
05050 
05060 
05070 
05080 
05090 
05100 
05110 
05120 


05140 
05150 
05160 
05170 
05180 
05190 
05200 
05210 
05220 
05230 
05240 
05250 
05260 
05270 
05280 
05290 
05300 
05310 
05320 
05330 
05340 
05350 
05360 
05370 
05380 
05390 
05400 
05410 


SMARTBUG 


LDA A BPOINT+2 


RETURN 


DISPLAY REGISTER STATUS 


$D,$A,0,0,0,4,'°S,'1,4 


04980 E39F A7 00 STA A X 
04990 E3A1 7E E24B DISPLY JMP 
E3A4 OD CRLFAS FCB 
E3A5 OA 
E3A6 00 
E3A7 00 
E3A8 00 
E3A9 04 
E3AA 53 
E3AB 31 
E3AC 04 
E3AD 8155 TDEX CMPA 
E3AF 27 OA BEQ 
E3B1 BD EOAC JSR 
E3B4 BD E057 JSR 
E3B7 09 DEX 
E3B8 7E EOA2 JMP 
E3BB 09 CHA71 DEX 
E3BC 09 DEX 
E3BD FF AOOC STX 
E3CO 7E E087 JMP 
E3C3.  FUTABL EQU 
E3C3 4D FCC 
E3C4 E085 FDB 
E3C6 47 FCC 
E3C7 E199 FDB 
E3C9 52 FCC 
E3CA E1EA FDB 
E3CC 54 FCC 
E3CD £237 FDB 
E3CF 49 FCC 
E3D0 E20F FDB 
E3D2 4B FCC 
E3D3 E189 FDB 
E3D5 34 FCC 
E3D6 E400 FDB 
E3D8 4A FCC 
E3D9 E1E6 FDB 
E3DB 51 FCC 
E3DC 8020 FDB 
E23DE 44 FCC 
E3DF 7283 > 223 FDB 
E3E1 48 FCC 
E3E2 E1C5 FDB 
E3E4 4C FCC 
E3E5 EQOA FDB 
E3E7 50 FCC 
E3E8 E127 FDB 
E3EA 45 FCC 
E3EB E1C4 FDB 


05420 


IF IT'S A "U" 
GET PREVIOUS ADDRESS 

IF NOT HEX, JMP CONTROL 
ELSE, GET NEW DATA 
STORE NEW DATA 

GET PREVIOUS ADDRESS 
PRINT PREVIOUS ADDRESS 
COMMAND LOOKUP TABLE 
MEMORY EXAMINE 

GO TO $A048 

PRINT REGISTERS 

TRACE ROUTINE 

MEMORY FILL 

SET BREAKPOINT 

GO TO $E400 

JUMP TO ADDRESS ENTERED 
QUICKSTART - BOOT DISC 
DISC WARMSTART 


SET HARDCOPY FLAG 


LOAD ASCII FORMATTED TAPE 
PUNCH ASCII FORMATTED TAPE 


TURN INPUT ECHO ON 
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05430 E3ED 4E 
05440 E3EE E1C6 
05450 E3F0 


05470 E3FO 13 
05480 E3F1 OD 
E3F2 OA 
E3F3 14 
E3F4 00 
E3F5 00 
E3F6 2A 
E3F7 04 


05500 E3F8 E000 
05510 E3FA E113 
05520 E3FC E005 
05530 E3FE EODO 


05550 


05570 A000 

05580 A000 0002 
05590 A002 0002 
05600 A004 0002 
05610 A006 0002 
05620 A008 0002 
05630 AOOA 0001 
05640 AOOB 0001 
05650 AOOC 0001 
05660 AOOD 0001 
05670 AOOE 0001 
05680 AOOF 0002 
05690 A011 0001 
05700 A012 0002 
05710 A014 0001 
05720 A015 002D 
05730 AOK2 0001 
05740 A043 001D 
05750 A060 0001 
05760 A061 0003 
05770 A064 0001 
05780 A065 0001 
05790 A066 0001 
05800 A067 0001 
05810 A068 0001 
05820 A069 0001 
05830 AO6A 0001 
05840 AO6B 0001 
05850 AOUA 


SMARTBUG 


FCC 
FDB 
TBLEND EQU 
MCLOFF FCB 
MCL FCB 
FDB 
FDB 
FDB 
FDB 
* RAM STORAGE 
ORG 
IOV RMB 
BEGA RMB 
ENDA RMB 
NIO RMB 
SP RMB 
ACIAT RMB 
ECHO RMB 
XHI RMB 
XLOW RMB 
TEMP RMB 
TW RMB 
TFLAG RMB 
XTEMP RMB 
BKFLG RMB 
RMB 
STACK RMB 
RMB 
TSTACK RMB 
BPOINT RMB 
MCONT RMB 
BFLAG RMB 
OPSAVE RMB 
PB1 RMB 
PB2 RMB 
PB3 RMB 
CKSM RMB 
BYTECT RMB 
PRINTR EQU 


/N/ 


ECHOFE TURN INPUT ECHO OFF 


$13 
$D,$A,$14,0,0,'*,4 


IO IRQ VECTOR 
SFE SWI VECTOR 
POWDWN NMI VECTOR 
START RESET VECTOR 
LOCATIONS 

$A000 


I/O INTERRUPT POINTER 
BEGINNING ADDRESS 
ENDING ADDRESS 

NMI INTERRUPT POINTER 
TARGET STACK POINTER 
ACIA STATUS WORD 
ECHO FLAG 

INDEX REG HI 

INDEX REG LOW 

TEMP 

TEMP 

TRACE FLAG 

X-REG TEMP STORAGE 
BREAKPOINT FLAG 
SMARTBUG STACK 

STACK POINTER 


TRACE MODE STACK 
BRANCH POINT ADDR & CODE 
TEMP 

BRANCH FLAG (TRACE) 
OPERAND (TRACE) 
TRACE TEMP 

TRACE TEMP 

TRACE TEMP 
CHECKSUM 

BYTE COUNT 

USER PRINT ROUTINE 


Brrr rte PAW HR HH BH NHN mH aH HO NNNNND 


2 
> 
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05870 END CRLF E1CB SP A008 
ACIAS 8008 PDAT1 E1CE ACIAT AOOA 
ACIAD 8009 OUTEEE E1D1 "ECHO AOOB 
10 «E000 OUTCH2 E1D9 XHI  AOOC 
POWDWN E005 OUTCH1 E1DA XLOW  AOOD 
LOAD EOOA JUMP E1E6 TEMP AQOE 
LOAD3 E013 PRINT E1EA T™  AOOF 
LOAD11 E02F C2 - E20C TFLAG A011 
LOAD15 E03B IFILL E20F XTEMP A012 
LOAD19 EO4O | FILLOP E217 BKFLG A014 
LOAD21 EOU4 C5 E21F STACK AO4#2 
C1 EO4Y PRINTS E221 TSTACK A060 
BADDR E047 OUTTH £232 BPOINT A061 
BYTE £055 OUT2 E234 MCONT A064 
OUTHL £067 TRACE £237 BFLAG A065 
OUTHR E06B RETURN E24B OPSAVE A066 
OUTCH E075 BBR E28D PB1 AO67 
INCH £078 BYT £292 PB2 A068 
PDATA2 E07B CH E295 PB3 A069 
PDATA1 EO7E OUT E297 CKSM .AO6A 
CHANGE E085 NOTB E29A BYTECT A06B 
CHA51 E087 BYT3 E2A4 PRINTR AOMA 
CHA61 EOA2 BYT2 E2A8 

INHEX EOAA BYT1 E2AA TOTAL ERRORS 00000 
IN1HG EOBE DPOS E2BA 

OUT2H EOBF NOTBB E2CB 

OUT2HA E0C1 CKCBA E2D9 

OUT4HS EOC8 RDC E2EB 

OUT2HS EOCA CHKX E2F5 

OUTS  EOCC RETDID E307 

START EODO RETNOT E30C 

INZ  EODE DOT  E30E 

INZ1 EOEO TSTB E322 

CONTRL EOE3 TSTJ £333 

NXTCHR EOFF ISJ E343 

GOODCH E10E ISX ESB 

SFE E113 NOTJ E35F 

PUNCH E127 NOTRTS E36A 

PUN11 E134 EXR £370 

PUN22 E146 NOTRTI E373 

PUN23 E148 EXEC E37B 

PUN32 E167 SWTURN E38C 

PUNT2 E182 DISPLY E3A1 

PRNT £187 CRLFAS E3A4 

BKPNT E189 TDEX E3AD 

CONTG £199 CHAT! = E3BB 

LIMITS £19D FUTABL E3C3 

OUS _—E1A9 TBLEND E3FO 

INEEE EAC | MCLOFF E3FO 

BAD2 £E1C1 MCL = «E3F 1 

ECHON E1C4 IOV A000 

PRNTON E1C5 BEGA A002 

ECHOFF E1C6 ENDA A004 


C3 E1C9 NIO A006 


